APPENDIX A 

Ink Object 

The folloing interface may be used to return basic information about the ink object. It may also 
return information that is shared among strokes and points for this ink object. For example, if the points 
in this ink object are "cursor down" points, this will be reported through this interface. If the points are 
recorded using the same tablet, and that tablet supports pressure, then it possible to find out that 
pressure is supported for all points. 

This interface supports the following features: 



Methods in Vtable Order 



\ lUnknown Methods 


Description 


\ Querylnterface 


Returns pointers to supported interfaces. 


i AddRef 


Increments reference count. 


: Keiease 








; Methods 


Description 


\ GetAttribute 


This function gets ink object attributes to a provided buffer 
location. 


\ \ 

\ : 

1 

\ GetBoundingBox 

^ i 

! 


This function returns the bounding rectangle of the ink in the 
ink space coordinates. The rectangle coordinates are in same 
units as the ink coordinates. The bounding box will take into 
account the pen width of the strokes in the ink object as well as \ 
other drawing attributes that apply for each stroke. For 
example, if a given stroke is drawTi as a Bezier fitted curve with i 
variable pressure, the method will correctly take into account 
all of these facts when computing the bounding box. 


\ GetPropertyList 


This fiinction returns to a provided buffer location the array of 
GUIDs of the properties that are global for this Ink Object. 


: GetPropertyData 

• 


This function is used by an application to query the ink object 
for the value associated with global ink property specified by 
GUID. If GUID passed in is not one of the global ink 
properties in the ink object the function fails. 


\ SetPropertyData 


This fimction is used by the application to create or change global | 
ink property specified by GUID. CalUng SetPropertyData for a 
GUID not in tiie Ink Object results in the property being created. If \ 
the property already exists then the value is ovenvritten. 
Predefined GUIDs values have an explicit type. 


1 DeletePropertyData 


This fimction deletes the ink property data of the property 
identified by GUID from the ink object. 


; GetDrawingAttributes 


Returns a set of drawing attributes associated with a cid for 
this ink object. | 



j 


Calling IInkObject::GetDrawing Attributes before calling 
IInkObject::SetDrawingAttributes will return the default set of 1 
drawing attributes. The drawing attributes associated with a 
given stroke can be obtained by calling 
IlnkStroke: :GetDrawingAttributes . 


3 ; 

I \ 

\ SetDrawingAttriubtes 


This function sets the drawing attributes for all the future 
strokes that will be drawn with this cursor id. If the ink is being 
generated by the appHcation and is not coming from a TC then 
set CID of zero Jf no drawing attributes are explicitly set for a \ 
cursor then the default drawing attributes are assumed. 
Calling IInkObject::SetDrawingAttributes does not increase the 
reference count on the Drawing attributes object since the 
attribute values are copied and saved in the Ink Object. Calling 
IlnkObj ect : : SetDrawing Attributes for the second time with 
uirierent attributes out tne same cursor la wui only cause 
subsequent strokes to be drawn with the new attributes but does \ 
not affect strokes already drawn. The drawing attributes can 
later be changed by calling 
IlnkStroke: :ModifyDrawingAttributes or 
IlnkObject : :ModifyDrawingAttributes . 


; ; 
^ ; 

\ IInkObject::ModifyDrawingAttributes 


This function modifies the drawing attributes of the already 
existing strokes, regardless of the cursor id that was originally 
used to record the strokes. Calling SetDrawingAttributes does 
not increase the reference count on the Drawing attributes 
object since the attribute values are copied and saved in the Ink j 
Obiect Calling TTnkObi ect* *]VfodifvDrawinff Attributes onlv 
affects the strokes specified by a stroke set and has no effect on 
the strokes that will be written in the future. The drawing 
attributes that will be drawn in the future will use the set of 
drawng attributes specified by 
IlnkObject: : SetDrawingAttributes, 


^ GetlnkSpaceRectangle 


This fiinction returns an Ink Space Rectangle for the current ink 
object. 


^ SetlnkSpaceRectangle 


This function sets the Ink Space Rectangle for the current ink 
object. 


j GetStrokeCount 


Returns a count of the strokes in the Ink Object. 


1 GetStroke 


Returns a stroke in the Ink Object. 


1 MergeStrokes 


Merges a contiguous range of strokes into a single stroke. 


? DeleteStrokes 


Deletes Strokes from a specified starting point. 


1 CreateStrokeSet 


Creates empty stroke set 


1 DeleteStrokeSet 


Deletes a stroke set 
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3 ; 

^ ExtractStrokeSet 


This ftmction creates a new ink object from a subset of strokes in 
the original ink object. Subset of strokes is specified as either 
strokes not contained in an identified stroke set or those contained 
in this stroke set, depending on a flag. The strokes in the original 
ink object are optionally deleted, depending on whether a flag is set. ] 


\ ClcMie 


Creates a new ink object, in memory, that is an exact clone of 
the original. The reference count of the new ink object is set to 
one upon successfiil return from this function. 




Delimits ink to be "cut" (as in cut and paste operation) or 
extracted out of an existing ink object. 


\ Trim 


This fijnction moves the bounding box of the ink to the origin 
and resets the Ink Space Rectangle of the ink object to be equal \ 
to its bounding box that is now aligned with the origin. j 


j IInkObject::Clip 


This fiinction clips the whole ink object to a specified rectangle, i 


: 

• ; 

\ MeigeSimple 

5 i 


Merges (or "pastes") the Source Ink Object into the current Ink 
Object at the target point. The strokes of the Source Ink Object are i 
sequentially appended after the strokes of the existing ink object 
and the coordinates are modified so that the ink is merged starting 
at the specified point. 


i Merse 


Merges (or "pastes") the Source Ink Object into the current Ink 
Object and scales it into the specified rectangle. The strokes of the \ 
Source Ink Object are sequentially appended after the strokes of 
the existing ink object and the coordinates are modified so that the 
ink is merged and scaled inside the rectangle. 


1 KtTest 


Use this fiinction to find out which strokes, if any, when drawn | 
taking into account the fiiU set of drawing attributes, intersect a \ 
given area. 


j SetCompressionMode 


This fiinction sets the compression mode used w^hen this object is 
serialized using IPersistStream: :Save fimction. 



IStrokeCoUect 



The IStrokeCoUect interface may be used to collect packets into a stroke. Supports the notion of 
adding ink to several strokes at the same time. 

This interfece supports the following features: 



Methods in Vtable Order 


^ lunknown 
^ Methods 


Description 


1 Querylnterface J 


Returns pointers to supported interfaces. 


1 AddRef 1 


Increments reference count. 


1 Release | 


Decrements reference count. 




\ Methods 


Description 


\ BeginStroke 


This function is called to start the collection of a new stroke. Typically this fiinction \ 
is called when the pen enters the proximity of the tablet or when it touches the tablet i 
surface. Two or more strokes can be collected at the same time, provided that they \ 
correspond to distinct cursor identifiers. Tlie stroke index is valid until EndStroke is 
called for the CID. 


i AppendPackets 


Add the specified packet to the stroke being constructed. 


i — — n 

i EndStroke 


Call this function when all packets have been added to the stroke (usally called on a 
cursor up). \ 



IlPersistStream 

Derived from standard COM IPersist interface. It has four methods: 



Methods in Vtable Order 



lunknown Methods | 


Description 


QueryLiterface ^ 


Returns pointers to supported iaterfeces. 


AddRef j 


Increments reference count. 


j Release ] 


Decrements reference count. 




; i 

Methods 


Description 


1 IPersistStream::IsDirty 


Tells whether object changed since it was last saved. 


IPersistStream: :Load 


Loads the object 


1 IPersistStream:: Save 


Saves the object and optionally clears the dirty flag. 


\ IPersistStream: :GetSi2eMax 


Compute the size of stream needed to store the whole object in the 
stream. That is the size after any compression. 
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ITransformInk 

This interfece is used to perform simple geometric transformations on the ink object. 
This interfece supports the following features: 



Methods in Vtable Order 



] lunknown Methods | 


Description 


1 Querylnterfece | 


Returns pointers to supported interfaces. 


] AddRef 1 


Increments reference count. 


1 Release | 


Decrements reference count. 




1 Methods 


Description 


] ITransformInk: :TranslateInk 


1 Translate a subset of strokes of an ink object by a specified x and 
1 y amount. 


I ITransformInk: :ScaleInk 


1 Scale a subset of strokes of an ink object by a specified amount. 


1 ITransformInk: :RotateInk 


1 Rotate a subset of strokes of an ink object by a specified amount. 


^ ITransformInk: :TransformInk 


1 Apply a linear transform to a subset of strokes of an ink object. 


\ ITransformInk: :FitInkToRectangle 


1 Scale and translate ink coordinates so that ink's bounding box is as \ 
1 specified. 



IRenderInk 



This is the interfece to Ink Rendering Services. It includes functions for drawing and measuring the ink 
output. The measuring functions closely parallel dra^ving functions. 
This interfece supports the following features: 



Methods in Vtable Order 



^ lunknown Methods 


Description 


1 Querylnterface 1 Returns pointers to supported interfaces. 


^ AddRef | Increments reference count. 


^ Release | Decrements reference count. 




] Methods 


Description 


1 IRenderInk: :DrawInkSimple 


Function used to draw the ink object. The ink is drawn in its natural 
aspect ratio, i.e. as it is drawn on the tablet, only it is scaled to fit the | 
specified height on the display and placed relative to the origin 
parameter as specified by an alignment parameter. The origin is 
placed along the sides of the resulting bounding box of the ink as 
specified by the ink alignment values in the alignment parameter. 


^ IRenderInk: :DrawInk 


Transforms the coordinates in the ink object to the GDI logical 
coordinates that all GDI drawing routines take as an input 


\ IRenderInk: :DrawInkInRectangle 


Draws a selected rectangular area in the ink space in a prescribed 
rectangular area in the GDI logical space. 


^ IRenderInk: :MeasureInkSimple 


Returns the logical ink coordinates of the bounding box in the 
application provided buffer. Returns the width given the height of the \ 
ink, and takes into account the width of the pen. When ink height is \ 
specified in absolute units (e.g., in points), the result is returned in 
hdc logical units. In this case, hdc needs to be passed to a function for | 
conversion between physical units to logical hdc units. 


1 IRenderInk: :MeasureInk 

1 


This function returns the bounding box of an ink when ink is drawn 
with a certain transform. Takes into account drawing attributes that 
apply to the strokes, such as the pen width, curve fitting etc. 
Prressure and angles may be taken into account and when ink is 
drawTi with curve fitting. 



ITrimInk 



This interfece is used to filter out the information fi-om the ink object that is not needed or desired by 
5 a given application. For instance, removing collinear points will result in Ae same drawing output^ assuming 
pressure and other packet properties are not taken into account. 
This interfece supports the following features: 
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Methods in Vtable Order 








^ lunknown Methods 


Descriotion 


] Querylnterfece 


Returns pointers to supported interfaces. 


1 AddRef 


Licrements reference count. 


1 Release 


Decrements reference count. 






1 Methods 


Description 


I ITrimInk: :RemoveCollinearPoints 


This function removes all packet data associated with collinear 1 
points. 


\ ITrimInk: iDeleteEraserStrokes 


Removes eraser data. 


\ ITrimInk: :DeletePenUpStrokes 


Removes pen up data. 


1 ITrimInk: :DeletePacketPropertyData 


This function removes data for the specified packet property 
from all ink packets in this ink object. 
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